Create, load, or unload partial customization files as you need them. Loading and using a partial CUIx file allows you to create and modify most user interface elements (toolbars, menus, ribbon panels, and so on) in a separate CUIx file without having to import the customization to your main CUIx file.

The order of the partial CUIx files in the Partial Customization Files tree determines the order they are loaded in the program. You can rearrange the tree hierarchy to change the load order. Use the Transfer tab of the Customize User Interface (CUI) Editor to create a partial CUIx file. For more information on creating a new CUIx file, see To create a CUIx file from scratch. CUIx files can be loaded or unloaded with the CUILOAD and CUIUNLOAD commands from the Command prompt, or you can use the Customize tab in the Customize User Interface (CUI) Editor.

Commands and user interface elements can be added to a partial CUIx file that is loaded under the main CUIx file, but not the enterprise CUIx file unless it is loaded as the main CUIx file. Before adding commands to a partial CUIx file, the partial CUIx file must be set as the working CUIx. For more information on adding a command to a partial CUIx file, see To add commands to a partial CUIx file.

When a partial CUIx file is loaded, any workspaces defined in the file cannot be set current. To use a workspace defined in a partial CUIx file, it must be transferred to the main CUIx file first. For more information on transferring a workspace to the main CUIx file, see To import a workspace to a main CUIx file.

Show Me: Load a Partial CUIx File

The following animation shows how to load a CUIx file as a partial CUIx file. Along with showing how to load a CUIx file as a partial CUIx file, it shows how to control the display of toolbars and menus contained in the partial CUIx file through the use of a workspace. For more information on workspaces, see Customize Workspaces.

Click the Play arrow to start the animation.

Procedure

To load a partial CUIx file using the CUILOAD command

1. At the Command prompt, enter cuiload.
2. In the Load/Unload Customizations dialog box, in the File Name text box, enter a path to the CUIx file you want to load, or click Browse to locate the file.
3. Click Load, and then click Close.

To load a partial CUIx file using the Customize tab

1. Click Manage tab Customization panel User Interface. At the command prompt, enter cui.
2. In the Customize User Interface Editor, Customize tab, in the Customizations In <file name> pane, select Main Customization File (<customization file name>.cuix) from the drop-down list. To the right of the drop-down list, click the Load Partial Customization File button.

   

3. In the Open dialog box, locate and select the partial CUIx file you want to load, and click Open.
   NoteIf the partial CUIx file you are attempting to load has the same customization group name as the main CUIx file, you need to change the customization group name before loading it. Open the partial CUIx file in the CUI Editor, select the customization group name, and right-click to rename it.
4. To verify that the file has been loaded into the main CUIx file, in the Customizations In <file name> pane, select the Main Customization File (<customization file name>.cuix) from the drop-down list.

   

   Loaded partial CUIx files in the main CUIx file are listed under the Partial Customization Files node.

   

5. Click Apply.

To unload a partial CUIx file using the CUIUNLOAD command

1. At the Command prompt, enter cuiunload.
2. In the Load/Unload Customizations dialog box, in the Loaded Customizations Group box, select a CUIx file.
3. Click Unload, and then click Close.

To unload a partial CUIx file using the Customize tab

1. Click Manage tab Customization panel User Interface. At the command prompt, enter cui.
2. In the Customize User Interface Editor, Customize tab, in the Customizations In <file name> pane, select Main Customization File (<customization file name>.cuix) from the drop-down list.

   

3. In the tree view of the main CUIx file, click the plus sign (+) next to the Partial Customization Files node to expand it.

   Any partial CUIx files loaded in the main CUIx file are displayed.

4. Right-click the partial CUIx file that you want to unload. Click Unload <customization file name>.cuix.

   

   The partial CUIx file is unloaded and removed from the list.

5. Click Apply.

To add commands to a partial CUIx file

1. Click Manage tab Customization panel User Interface. At the command prompt, enter cui.
2. In the Customize User Interface Editor, Customize tab, in the Customizations In <file name> pane, select the partial CUIx file from the drop-down list.

   

3. In the Commands List pane, click Create a New Command.

   

4. Adjust the properties of the new command in the Properties pane as necessary.
5. Click Apply.

Quick Reference

Commands

CUI

Manages the customized user interface elements in the product.

CUILOAD

Loads a CUIx file.

CUIUNLOAD

Unloads a CUIx file.